DropCompleted

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

DropCompleted
The DropCompleted method is called to notify this part that a drop operation, resulting from an asynchronous drag initiated from this part, is complete.
void DropCompleted (in ODPart destPart, 
                    in ODDropResult dropResult);
destPart
A reference to a part where the drop is to be completed.
dropResult
The result of the drop operation. The value of dropResult must be one of the following: kODDropFail, kODDropCopy, kODDropMove, or kODDropUnfinished.

DISCUSSION
The return value kODDropFail indicates an unsuccessful synchronous drop. The return value kODDropCopy indicates a successful synchronous drop with copy semantics. The return value kODDropMove indicates a successful synchronous drop with move semantics. On platforms that support asynchronous drag-and-drop operations, the return value kODDropUnfinished indicates that an asynchronous drop is in progress.
OpenDoc calls this method at the end of a drop operation resulting from an asynchronous drag initiated from this part.
If the drag-and-drop object's StartDrag method is executed synchronously, then that method's return value is this method's drop result.
Your part's DropCompleted method should perform any tasks that your part normally performs when it receives the result of a StartDrag method, modifying or restoring this part's data based on the drop result.

Mac OS
Asynchronous dragging is not supported for version 1.0 of OpenDoc for the Mac OS. This method is provided here for compatibility with future versions of OpenDoc.

OVERRIDING
When you subclass ODPart, you can override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrDoesNotDrop
This part does not support drag and drop.

SEE ALSO
The ODDropResult type (page 922).
The ODDragAndDrop::StartDrag method (page 195).
The ODPart::Drop method (page 506).
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Completion of StartDrag" on page 368 in OpenDoc Programmer's Guide.